package tech.waterism.service.config;

import lombok.extern.slf4j.Slf4j;
import org.springframework.aop.interceptor.AsyncUncaughtExceptionHandler;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.AsyncConfigurer;
import org.springframework.scheduling.annotation.EnableAsync;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import java.util.concurrent.Executor;
import java.util.concurrent.ThreadPoolExecutor;

/**
 * 异步任务配置
 *
 * <p>配置水文模型计算的异步线程池，针对CPU密集型计算优化。</p>
 *
 * <h3>线程池策略：</h3>
 * <ul>
 *   <li>核心线程数 = CPU核心数（充分利用CPU）</li>
 *   <li>最大线程数 = CPU核心数 * 2（CPU密集型不宜过多线程）</li>
 *   <li>队列容量 = 100（缓冲突发请求）</li>
 *   <li>拒绝策略 = CallerRunsPolicy（降级到同步调用，避免丢失任务）</li>
 * </ul>
 *
 * @author 高宇
 * @since 1.0.0
 */
@Slf4j
@Configuration
@EnableAsync
public class AsyncConfig implements AsyncConfigurer {

    /**
     * 自定义异步线程池 - 用于水文模型计算
     *
     * <p>针对CPU密集型计算优化：</p>
     * <ul>
     *   <li>避免过多线程导致上下文切换</li>
     *   <li>合理设置队列容量，平衡吞吐量和响应速度</li>
     *   <li>优雅关闭，等待任务完成</li>
     * </ul>
     */
    @Override
    @Bean(name = "modelExecutor")
    public Executor getAsyncExecutor() {
        int availableProcessors = Runtime.getRuntime().availableProcessors();
        
        log.info("初始化模型计算线程池 - CPU核心数: {}", availableProcessors);
        
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        
        // 核心线程数 = CPU核心数
        // CPU密集型任务，线程数不宜超过CPU核心数太多
        executor.setCorePoolSize(availableProcessors);
        
        // 最大线程数 = CPU核心数 * 2
        // 留出一定弹性空间处理突发请求
        executor.setMaxPoolSize(availableProcessors * 2);
        
        // 队列容量 - 100个任务
        // 当核心线程都忙时，新任务进入队列等待
        executor.setQueueCapacity(100);
        
        // 线程名前缀 - 便于日志追踪
        executor.setThreadNamePrefix("hydro-model-");
        
        // 拒绝策略：CallerRunsPolicy
        // 当线程池和队列都满时，在调用者线程中运行任务
        // 这样可以降级到同步执行，避免丢失任务
        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        
        // 优雅关闭：等待所有任务完成后再关闭
        executor.setWaitForTasksToCompleteOnShutdown(true);
        executor.setAwaitTerminationSeconds(60);
        
        // 允许核心线程超时
        executor.setAllowCoreThreadTimeOut(true);
        executor.setKeepAliveSeconds(300); // 5分钟无任务则回收线程
        
        executor.initialize();
        
        log.info("模型计算线程池初始化完成 - 核心线程: {}, 最大线程: {}, 队列容量: {}", 
                availableProcessors, availableProcessors * 2, 100);
        
        return executor;
    }

    /**
     * 异步任务异常处理器
     */
    @Override
    public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
        return (ex, method, params) -> {
            log.error("异步任务执行异常 - 方法: {}, 参数数量: {}", 
                    method.getName(), params.length, ex);
            log.error("异常详情: {}", ex.getMessage());
        };
    }
}

